Rone Arena API
v1.2.3

Requests go to https://arena.rone.dev/api. Forms are generated from the OpenAPI schema.

GET /api/heroes/{hero_identifier}/compatibility

Hero Compatibility

Get compatibility information for a specific hero by ID or name. Supports query parameters for rank tier, pagination, and localization.

Path parameters:

  • hero_identifier: Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin.

Query parameters:

  • days: Time window for compatibility data. Allowed values: 1, 3, 7, 15, 30.
  • rank: Rank filter. Allowed values: all, epic, legend, mythic, honor, glory.
  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • lang: Language code for localized content (default: en).

The response includes hero compatibility data:

  • records: Array of hero entries, each containing:
      • _id: Unique record identifier.
      • _createdAt: Creation timestamp.
      • _updatedAt: Last update timestamp.
      • data:
          • main_hero:
              • data:
                  • head: Main hero portrait image URL.
                  • name: Main hero name.
          • main_heroid: Main hero ID.
          • main_hero_channel:
              • id: Channel ID reference.
          • main_hero_appearance_rate: Pick rate of the main hero.
          • main_hero_ban_rate: Ban rate of the main hero.
          • main_hero_win_rate: Win rate of the main hero.
          • sub_hero: Array of compatible heroes, each containing:
              • heroid: Compatible hero ID.
              • hero_win_rate: Compatible hero win rate.
              • hero_appearance_rate: Compatible hero pick rate.
              • increase_win_rate: Positive synergy impact on win rate.
              • hero_channel:
                  • id: Channel ID reference.
              • hero:
                  • data:
                      • head: Compatible hero portrait image URL.
              • min_win_rate6 through min_win_rate20: Win rate breakdown across match durations.
          • sub_hero_last: Array of negative synergy heroes, each containing:
              • heroid: Sub-hero ID.
              • hero_win_rate: Sub-hero win rate.
              • hero_appearance_rate: Sub-hero pick rate.
              • increase_win_rate: Negative impact on win rate.
              • min_win_rate6 through min_win_rate20: Win rate breakdown across match durations.

This endpoint is useful for:

  • Identifying which heroes pair well with the selected hero.
  • Analyzing synergy and team composition effectiveness.
  • Recognizing combinations that reduce performance.
  • Understanding matchup dynamics across ranks and match durations.
Example response
{
  "code": 0,
  "message": "OK",
  "data": {
    "records": [
      {
        "_createdAt": 1724837698334,
        "_id": "66ceef42af5771f18c500d18",
        "_updatedAt": 1774890906262,
        "data": {
          "bigrank": "9",
          "camp_type": "1",
          "main_hero": {
            "data": {
              "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_3391df36d6dcc54dd1c417098e15ec59.png",
              "name": "Fanny"
            }
          },
          "main_hero_appearance_rate": 0.009896,
          "main_hero_ban_rate": 0.073593,
          "main_hero_channel": {
            "id": 2678753
          },
          "main_hero_win_rate": 0.458363,
          "main_heroid": 17,
          "match_type": "1",
          "sub_hero": [
            {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage%2F100_6495be044c2d28106e200f6918391d54.png"
                }
              },
              "hero_appearance_rate": 0.001064,
              "hero_channel": {
                "id": 2678835
              },
              "hero_index": 1,
              "hero_win_rate": 0.487066,
              "heroid": 99,
              "increase_win_rate": 0.080441,
              "min_win_rate10_12": 0.536232,
              "min_win_rate12_14": 0.616162,
              "min_win_rate14_16": 0.483333,
              "min_win_rate16_18": 0.534247,
              "min_win_rate18_20": 0.469388,
              "min_win_rate20": 0.525424,
              "min_win_rate6": 0,
              "min_win_rate6_8": 0,
              "min_win_rate8_10": 0.363636
            }
          ],
          "sub_hero_last": [
            {
              "hero": {
                "data": {
                  "head": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fhomepage_1_9_47%2F100_d2d28d2fcb060726fa27553920ca1a33.png"
                }
              },
              "hero_appearance_rate": 0.003218,
              "hero_channel": {
                "id": 2678805
              },
              "hero_index": 1,
              "hero_win_rate": 0.447087,
              "heroid": 69,
              "increase_win_rate": -0.125309,
              "min_win_rate10_12": 0.096154,
              "min_win_rate12_14": 0.22973,
              "min_win_rate14_16": 0.25,
              "min_win_rate16_18": 0.342857,
              "min_win_rate18_20": 0.526316,
              "min_win_rate20": 0.531915,
              "min_win_rate6": 0,
              "min_win_rate6_8": 0,
              "min_win_rate8_10": 0.0625
            }
          ]
        },
        "id": 102938,
        "sourceId": 2756569
      }
    ],
    "total": 1
  }
}
hero_identifier · path

Hero identifier as numeric hero ID or hero name. Accepts values like 30, Yi Sun-shin, or yisunshin. Name matching ignores spaces/symbols and is case-insensitive (e.g., Luo Yi to luoyi).

days · query

Past day window for rank statistics.

rank · query

Rank filter for hero statistics.

size · query

Number of items per page. Minimum: 1.

index · query

Page index for pagination. Minimum: 1.

lang · query

Language code for localized content.

GET /api/heroes/{hero_identifier}/compatibility